Skip to content

Comments

feat: add security review skill to plan implementation#482

Open
dotuananh0712 wants to merge 3 commits intoobra:mainfrom
dotuananh0712:feat/security-reviewer-479
Open

feat: add security review skill to plan implementation#482
dotuananh0712 wants to merge 3 commits intoobra:mainfrom
dotuananh0712:feat/security-reviewer-479

Conversation

@dotuananh0712
Copy link

@dotuananh0712 dotuananh0712 commented Feb 15, 2026

Summary

  • Enhanced code-reviewer.md with comprehensive security checklist (OWASP Top 10)
  • Added new security-reviewer.md template for security-focused reviews
  • Added new security-reviewer-prompt.md for dispatching security subagents
  • Updated subagent-driven-development workflow to include optional security review

This addresses the issue that code review skill was not fully realized,
and adds dedicated security review to the implementation process.

Fixes #479

Summary by CodeRabbit

  • New Features

    • Integrated security review stage into the development workflow with dedicated approval gates and security fix loops.
  • Documentation

    • Enhanced code review guidance with command execution best practices.
    • Added context management guidance for optimizing implementation efficiency.
    • Introduced comprehensive security review templates and assessment checklists.

Adds guidance to run git diff commands separately instead of
chaining with && to avoid consent prompts.

Fixes obra#476
After generating a detailed implementation plan, clear context to free
up memory for implementation and debugging.

Fixes obra#478
- Enhanced code-reviewer.md with comprehensive security checklist
- Added new security-reviewer.md template with OWASP Top 10 checks
- Added new security-reviewer-prompt.md for dispatching security subagents
- Updated subagent-driven-development workflow to include optional security review

This addresses the issue that code review skill was not fully realized,
and adds dedicated security review to the implementation process.

Fixes obra#479
@coderabbitai
Copy link

coderabbitai bot commented Feb 15, 2026

📝 Walkthrough

Walkthrough

This PR integrates a dedicated security review stage into the development workflow, positioned after code quality checks. It includes new security review documentation with comprehensive checklists, improves existing code review guidance, adds memory management instructions for implementation, and updates the task workflow to dispatch security reviewers and handle security fixes.

Changes

Cohort / File(s) Summary
Memory Management
skills/executing-plans/SKILL.md
Adds "Clear context" sub-bullet to Step 1 with guidance to clear Claude's context window for increased available memory during implementation and debugging.
Code Review Enhancement
skills/requesting-code-review/code-reviewer.md
Updates documentation with guidance to run commands separately without chaining, and augments review checklist with explicit Security items and "Defense in depth applied?" question under Architecture.
Security Review Documentation
skills/requesting-code-review/security-reviewer.md
New comprehensive security review template covering authentication, input validation, data protection, cryptography, dependency security, error handling, and common vulnerabilities, with structured output format and critical rules.
Workflow Integration & Security Prompt
skills/subagent-driven-development/SKILL.md, skills/subagent-driven-development/security-reviewer-prompt.md
Integrates security review path into per-task workflow after code quality approval; adds new security reviewer prompt template with placeholders for implementation details, plan references, and git range specifications.

Sequence Diagram(s)

sequenceDiagram
    participant Implementer
    participant CodeQualityReviewer as Code Quality<br/>Reviewer
    participant SecurityReviewer as Security<br/>Reviewer
    participant TaskCompletion as Task<br/>Completion

    Implementer->>CodeQualityReviewer: Submit implementation
    CodeQualityReviewer->>CodeQualityReviewer: Review code quality
    alt Code Quality Issues
        CodeQualityReviewer-->>Implementer: Request changes
        Implementer->>CodeQualityReviewer: Resubmit
    else Code Quality Approved
        CodeQualityReviewer->>SecurityReviewer: Dispatch security review
        SecurityReviewer->>SecurityReviewer: Perform security review
        alt Security Issues Found
            SecurityReviewer-->>Implementer: Report vulnerabilities
            Implementer->>Implementer: Fix security issues
            Implementer->>SecurityReviewer: Resubmit for review
        else Security Approved
            SecurityReviewer->>TaskCompletion: Approve
            TaskCompletion->>TaskCompletion: Complete task
        end
    end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 Whiskers twitch with security delight,
Code flows through reviewers, both day and night,
From quality gates to vulnerabilities caught,
Each context cleared, each lesson taught,
The warren grows safer, layer by layer bright! 🔐✨

🚥 Pre-merge checks | ✅ 6
✅ Passed checks (6 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately reflects the main objective: adding a security review skill to the plan implementation workflow.
Linked Issues check ✅ Passed The PR comprehensively addresses issue #479 by improving the code review skill and adding a dedicated security review skill into the plan-implementation process as required.
Out of Scope Changes check ✅ Passed All changes are scoped to the stated objectives: code-reviewer.md enhancements, new security review templates, and workflow integration for security reviews.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Merge Conflict Detection ✅ Passed ✅ No merge conflicts detected when merging into main

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
skills/subagent-driven-development/SKILL.md (1)

56-83: ⚠️ Potential issue | 🟡 Minor

Fix DOT node/edge shapes for valid diagram semantics.

“Dispatch security reviewer” is an action (box), and shape on an edge is not valid DOT—this can break rendering or mislead readers.

🧩 Suggested DOT fixes
-        "Dispatch security reviewer subagent (./security-reviewer-prompt.md)?" [shape=diamond];
+        "Dispatch security reviewer subagent (./security-reviewer-prompt.md)" [shape=box];

 ...
-    "Dispatch security reviewer subagent (./security-reviewer-prompt.md)?" -> "Security reviewer subagent approves?" [shape=diamond];
+    "Dispatch security reviewer subagent (./security-reviewer-prompt.md)" -> "Security reviewer subagent approves?";
🤖 Fix all issues with AI agents
In `@skills/executing-plans/SKILL.md`:
- Around line 23-25: The "Clear context" step may remove plan details created by
TodoWrite needed for Step 2; update SKILL.md to instruct preserving the plan
before clearing by saving the plan state (e.g., persist the TodoWrite output or
store a plan identifier) or explicitly reloading/reopening the plan after
clearing the window so Step 2 can access it; reference the TodoWrite action and
the Step 2 usage in the text and add a short sentence explaining how to
persist/reopen the plan (persist to storage or emit a plan token) immediately
before the "Tell Claude Code to clear its context/window" instruction.

In `@skills/requesting-code-review/security-reviewer.md`:
- Around line 45-51: Reword the "Input Validation:" checklist to remove
repetitive "No ..." starters for readability by changing each bullet to concise
negative-check phrases (e.g., "SQL injection risks?" -> "SQL injection risks
present?" or "Resistant to SQL injection?"; "command injection risks?" ->
"Resistant to command injection?"; "path traversal vulnerabilities?" -> "Path
traversal vulnerabilities present?"; "XSS prevention in place?" -> "XSS
prevention implemented?") while keeping the original intent and question format;
update the bullets under the "Input Validation" heading so they read
consistently and scan easily.

In `@skills/subagent-driven-development/SKILL.md`:
- Around line 194-200: The phrase "Two-stage review" under the "Quality gates:"
section is now incorrect; update the wording to "Three-stage review" and adjust
the bulleted sequence that currently reads "Two-stage review: spec compliance,
then code quality, then security (optional)" to explicitly reflect three stages
(spec compliance, code quality, security) and remove "(optional)" so it matches
the added security review; edit the "Quality gates:" block (the heading and its
bullets) to replace "Two-stage review" with "Three-stage review" and ensure the
bullets list the three stages in order.

@Artemnikov
Copy link

That would be amazing tool!
Love to see that

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Code/security review

2 participants